All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.std.image.Matrix

java.lang.Object
   |
   +----quicktime.util.QTByteObject
           |
           +----quicktime.std.image.Matrix

public final class Matrix
extends QTByteObject
implements QuickTimeLib, Cloneable
A Matrix defines how to map points from one coordinate space into another coordinate space.


Variable Index

 o kNativeSize
This is the size (the number of bytes) that are required for this class

Constructor Index

 o Matrix()
Construct an instance of a Matrix, with default settings of the identity Matrix
 o Matrix(float[][])
Construct an instance of a Matrix from the values of a float[][], which is a 3x3 table, - an array of row values.
 o Matrix(QDPoint[], QDPoint[])
Construct a Matrix that is a delta matrix between the two sets of 4 points.

Method Index

 o clone()
copies the contents of the one matrix into another matrix.
 o concat(Matrix)
Concatenates two matrices, combining the transformations described by both matrices into a single matrix.
 o copy()
copies the contents of the one matrix into another matrix.
 o equals(Matrix)
Compares the contents of a matrix for Equality.
 o getB()
Gets the b value.
 o getC()
Gets the c value.
 o getSx()
Gets the X axis scale amount.
 o getSy()
Gets the Y axis scale amount.
 o getTx()
Gets the X axis translation amount.
 o getTy()
Get the Y axis translation amount.
 o getType()
Obtains information about the matrix.
 o getU()
Gets the u value.
 o getV()
Gets the v value.
 o getW()
Gets the w value.
 o inverse(Matrix)
creates a new matrix that is the inverse of a specified matrix.
 o isIdentity()
Returns true if the matrix is an identity matrix otherwise false
 o map(QDRect, QDRect)
alters an existing matrix so that it defines a transformation from one rectangle to another.
 o rect(QDRect, QDRect)
creates a matrix that performs a translate and scale operation as described by the relationship between two rectangles.
 o rotate(float, float, float)
modifies the contents of a matrix so that is defines a rotation operation.
 o scale(float, float, float, float)
modifies the contents of a matrix so that it defines a scaling operation.
 o setB(float)
Set b by specified amount.
 o setC(float)
Set c by specified amount.
 o setIdentity()
Set the contents of a matrix so that it performs no transformation.
 o setSx(float)
Set the X axis Scale by specified amount.
 o setSy(float)
Set the Y axis Scale by specified amount.
 o setTx(float)
Set the X axis translation by specified amount.
 o setTy(float)
Set the Y axis translation by specified amount.
 o setU(float)
Set u by specified amount.
 o setV(float)
Set v by specified amount.
 o setW(float)
Set w by specified amount.
 o skew(float, float, float, float)
modifies the contents of a matrix so that it defines a skew transformation.
 o toString()
Prints the matrix.
 o transformDPoints(QDPoint)
Transforms a set of fixed points through a specified matrix.
 o transformDPoints(QDPoint[])
Transforms a set of fixed points through a specified matrix.
 o transformDRect(QDRect)
transforms the upper left and lower right points of a rectangle through a specified matrix.
 o transformDRect(QDRect, QDPoint[])
transforms the upper left and lower right points of a rectangle through a specified matrix.
 o transformPoints(QDPoint)
transforms a set of QuickDraw points through a specified matrix.
 o transformPoints(QDPoint[])
transforms a set of QuickDraw points through a specified matrix.
 o transformRect(QDRect)
transforms the upper left and lower right points of a rectangle through a specified matrix.
 o transformRect(QDRect, QDPoint[])
transforms the upper left and lower right points of a rectangle through a specified matrix.
 o transformRgn(Region)
applies a specified matrix to a region.
 o translate(float, float)
add a translation value to a specified matrix.

Variables

 o kNativeSize
 public static final int kNativeSize
This is the size (the number of bytes) that are required for this class

Constructors

 o Matrix
 public Matrix()
Construct an instance of a Matrix, with default settings of the identity Matrix

 o Matrix
 public Matrix(float table[][])
Construct an instance of a Matrix from the values of a float[][], which is a 3x3 table, - an array of row values.

Parameters:
table - a 3x3 table of float values.
 o Matrix
 public Matrix(QDPoint source[],
               QDPoint dest[]) throws QTException
Construct a Matrix that is a delta matrix between the two sets of 4 points. This call is available only in QuickTime 4 or later. The resulting matrix can be concatenated with the matrix from which the source points are derived to transform the display object to the destination area.

QuickTime::QuadToQuadMatrix

Parameters:
source - a set of 4 points t,l t,r b,r and b,l that describes the source area
dest - a set of 4 points t,l t,r b,r and b,l that describes the destination area

Methods

 o setTx
 public void setTx(float tx)
Set the X axis translation by specified amount.

Parameters:
tx - amount to set x-axis translation
 o getTx
 public float getTx()
Gets the X axis translation amount.

Returns:
x-axis translation
 o setTy
 public void setTy(float ty)
Set the Y axis translation by specified amount.

Parameters:
ty - amount to set y-axis translation
 o getTy
 public float getTy()
Get the Y axis translation amount.

Returns:
y-axis translation
 o setSx
 public void setSx(float sx)
Set the X axis Scale by specified amount.

Parameters:
sx - amount to set x-axis scale.
 o getSx
 public float getSx()
Gets the X axis scale amount.

Returns:
x-axis scale.
 o setSy
 public void setSy(float sy)
Set the Y axis Scale by specified amount.

Parameters:
sy - amount to set x-axis scale.
 o getSy
 public float getSy()
Gets the Y axis scale amount.

Returns:
Y-axis scale.
 o setB
 public void setB(float b)
Set b by specified amount.

Parameters:
b - amoutn specified.
 o getB
 public float getB()
Gets the b value.

Returns:
b value.
 o setU
 public void setU(float u)
Set u by specified amount.

Parameters:
u - amount specified.
 o getU
 public float getU()
Gets the u value.

Returns:
u value.
 o setC
 public void setC(float c)
Set c by specified amount.

Parameters:
c - amount specified.
 o getC
 public float getC()
Gets the c value.

Returns:
c value.
 o setV
 public void setV(float v)
Set v by specified amount.

Parameters:
v - amount specified.
 o getV
 public float getV()
Gets the v value.

Returns:
v value.
 o setW
 public void setW(float w)
Set w by specified amount.

Parameters:
w - amount specified.
 o getW
 public float getW()
Gets the w value.

Returns:
w value.
 o getType
 public short getType()
Obtains information about the matrix.

QuickTime::GetMatrixType

Returns:
indicates the nature of the transformation defined by Matrix.
 o isIdentity
 public boolean isIdentity()
Returns true if the matrix is an identity matrix otherwise false

 o setIdentity
 public void setIdentity()
Set the contents of a matrix so that it performs no transformation.

QuickTime::SetIdentityMatrix

 o translate
 public void translate(float deltaH,
                       float deltaV)
add a translation value to a specified matrix.

QuickTime::TranslateMatrix

Parameters:
deltaH - specifies the value to be added to the x coordinate translation value.
dletaV - specifies the value to be added to the y coordinate translation value.
 o rotate
 public void rotate(float degrees,
                    float aboutX,
                    float aboutY)
modifies the contents of a matrix so that is defines a rotation operation.

QuickTime::RotateMatrix

Parameters:
degrees - specifies the number of degrees of rotation.
aboutX - specifies the x coordinate of the anchor point of rotation.
aboutY - specifies the y coordinate of the anchor point of rotation.
 o scale
 public void scale(float scaleX,
                   float scaleY,
                   float aboutX,
                   float aboutY)
modifies the contents of a matrix so that it defines a scaling operation.

QuickTime::ScaleMatrix

Parameters:
scaleX - specifies the scaling factor applied to x coordinates.
scaleY - specifies the scaling factor applied to y coordinates.
aboutX - specifies the x coordinate of the anchor point.
aboutY - specifies the y coordinate of the anchor point.
 o skew
 public void skew(float skewX,
                  float skewY,
                  float aboutX,
                  float aboutY)
modifies the contents of a matrix so that it defines a skew transformation.

QuickTime::SkewMatrix

Parameters:
skewX - specifies the skew value to be applied to x coordinate.
skewY - specifies the skew value to be applied to y coordinate.
aboutX - specifies the x coordinate of the anchor point.
aboutY - specifies the y coordinate of the anchor point.
 o inverse
 public boolean inverse(Matrix mr)
creates a new matrix that is the inverse of a specified matrix.

QuickTime::InverseMatrix

Parameters:
mr - specifies the new inverse matrix.
Returns:
true if inverse matrix was created, else return false.
 o concat
 public void concat(Matrix b)
Concatenates two matrices, combining the transformations described by both matrices into a single matrix.

QuickTime::ConcatMatrix

Parameters:
mr - the destination matrix.
 o transformDPoints
 public void transformDPoints(QDPoint dpt) throws QTException
Transforms a set of fixed points through a specified matrix.

QuickTime::TransformFixedPoints

Parameters:
dpts - a set of float points.
 o transformDPoints
 public void transformDPoints(QDPoint dpts[]) throws QTException
Transforms a set of fixed points through a specified matrix.

QuickTime::TransformFixedPoints

Parameters:
dpts - a set of float points.
 o transformPoints
 public void transformPoints(QDPoint pt) throws StdQTException
transforms a set of QuickDraw points through a specified matrix.

QuickTime::TransformPoints

Parameters:
pts - an array of Points.
 o transformPoints
 public void transformPoints(QDPoint pts[]) throws StdQTException
transforms a set of QuickDraw points through a specified matrix.

QuickTime::TransformPoints

Parameters:
pts - an array of Points.
 o transformDRect
 public boolean transformDRect(QDRect r) throws QTException
transforms the upper left and lower right points of a rectangle through a specified matrix.

QuickTime::TransformFixedRect

Parameters:
r - the QDRect to be transformed.
Returns:
false if the transformation is other than scaling and translation.
 o transformDRect
 public boolean transformDRect(QDRect r,
                               QDPoint points[]) throws QTException
transforms the upper left and lower right points of a rectangle through a specified matrix.

QuickTime::TransformFixedRect

Parameters:
r - the QDRect to be transformed.
bound - an array of four float points.
Returns:
false if the transformation is other than scaling and translation.
 o transformRect
 public boolean transformRect(QDRect r) throws QTException
transforms the upper left and lower right points of a rectangle through a specified matrix.

QuickTime::TransformRect

Parameters:
r - the rectangle to be transformed.
Returns:
false if the transformation is other than scaling and translation.
 o transformRect
 public boolean transformRect(QDRect r,
                              QDPoint points[]) throws QTException
transforms the upper left and lower right points of a rectangle through a specified matrix.

QuickTime::TransformRect

Parameters:
r - the rectangle to be transformed.
bounds - an array of four float points.
Returns:
false if the transformation is other than scaling and translation.
 o transformRgn
 public void transformRgn(Region r) throws StdQTException
applies a specified matrix to a region.

QuickTime::TransformRgn

Parameters:
r - the region to be transformed.
 o rect
 public void rect(QDRect srcRect,
                  QDRect dstRect)
creates a matrix that performs a translate and scale operation as described by the relationship between two rectangles.

QuickTime::RectMatrix

Parameters:
srcRect - the source rectangle.
dstRect - the destination rectangle.
 o map
 public void map(QDRect fromRect,
                 QDRect toRect)
alters an existing matrix so that it defines a transformation from one rectangle to another.

QuickTime::MapMatrix

Parameters:
fromRect - the source rectangle.
toRect - the destination rectangle.
 o toString
 public String toString()
Prints the matrix.

Overrides:
toString in class QTByteObject
 o copy
 public Matrix copy()
copies the contents of the one matrix into another matrix.

QuickTime::CopyMatrix

Returns:
a clone Matrix.
 o clone
 public Object clone()
copies the contents of the one matrix into another matrix.

QuickTime::CopyMatrix

Returns:
a clone Matrix.
Overrides:
clone in class Object
 o equals
 public boolean equals(Matrix m)
Compares the contents of a matrix for Equality.

QuickTime::EqualMatrix

Parameters:
m - the Matrix you are testing for equality.
Returns:
a boolean of whether the matrices are equal.

All Packages  Class Hierarchy  This Package  Previous  Next  Index